home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / rnode10.zip / RNODE.DOC < prev    next >
Text File  |  1992-09-23  |  12KB  |  239 lines
  1.  
  2.     RNODE.DOC                                          Page:1
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                RNODE Version 1.0
  10.                       RBBS-PC Multinode Take Down Utility
  11.          Copyright (C) 1992 Lightning Software, All Rights Reserved
  12.                     Written And Coded By Robert L. Folmer
  13.  
  14.          ***Bear Cat BBS Home Of Lightning Software (404) 739-1216***
  15.  
  16.          Warranty
  17.          ========
  18.          RNODE 1.0 is distributed without warranty.  In no event
  19.          will Lightning Software be liable to you for any damages from
  20.          running this program. Including any loss of profits, lost
  21.          savings, or other incidental or consequential damages arising
  22.          out of your use of or inability to use the program, even if
  23.          Lightning Software or a authorized representative has been
  24.          advised of the possibility of such damages.
  25.          Lightning Software will not be liable for any such claim by
  26.          any other party. All risk associated with using this program
  27.          are the complete responsibility of the user.
  28.  
  29.          Introduction - What RNODE Does
  30.          ==============================
  31.          RNODE is a utility for use with RBBS-PC that takes a node down while
  32.          another node is currently running an event. The program has many
  33.          uses. Taking a node offline during system events is usually a good
  34.          idea to do and some events running while any other nodes are running
  35.          make it necessary for protection. Some events such as mail runs can
  36.          conflict if other nodes are active, and some programs such as message
  37.          base packing utilities like MU-PURGE can damage RBBS's data files and
  38.          corrupt message bases if ANY nodes are active. As stated earlier, it's
  39.          a good idea to take all nodes offline until an event completes, not
  40.          only to prevent costly damage, but also to avoid lock ups caused by
  41.          sharing violations. Use RNODE and you will be safe. RNODE is designed
  42.          to bring RBBS's lines down for system maintnance, and will not place
  43.          them back up until the event has completed. RNODE is also a snap to
  44.          install and is very easy to use, this next section describes important
  45.          installation procedures for RNODE 1.0, please read it carefully before
  46.          using RNODE. Please remember that RNODE is released as shareware, you
  47.          are free to use the software on your RBBS-PC for a period of 30 days,
  48.          after which you must register the software for $10.00 to continue it's
  49.          use. We hope that you find RNODE to be a useful RBBS utility, and will
  50.          support it's continued development by registering today!
  51.  
  52.          Installation
  53.          ============
  54.          RNODE is designed with ease of installation in mind, the following
  55.          shows you step by step how to install and use RNODE...
  56.  
  57.          If you have not done so already, edit your RBBS start up batch file(s)
  58.          to change the name of the daily event file in which RBBS invokes,
  59.          change all occurances of RBBSTIME.BAT to a name in which you would
  60.  
  61.  
  62.     RNODE.DOC                                          Page:2
  63.  
  64.  
  65.  
  66.          prefer, for clarity we recommend RBBSTM#.BAT where # is the node
  67.          number of the batch file you are currently editing. You may name the
  68.          file any name you wish, the above is suggested only as an example.
  69.          This procedure allows RBBS to run seperate events on each node, which
  70.          is required for RNODE to function properly.
  71.  
  72.          1.) Create a directory to hold all of the RNODE files, you may name
  73.              the directory what you wish, however for clarity we recommend
  74.              RNODE. Next edit your AUTOEXEC.BAT file to include the newly
  75.              created directory in your PATH statement, note that this is not
  76.              necessary for proper operation, however it does make using the
  77.              software much easier. Without RNODE included in the DOS PATH, it
  78.              is necessary to either change to the directory containing RNODE's
  79.              files, or include the full path to it's files when running the
  80.              program.
  81.  
  82.          2.) Uncompress the RNODE distribution archive into the above created
  83.              directory. You may now run RNODE to be sure it is working properly
  84.              this can be done by entering RNODE at the DOS prompt, typing
  85.              RNODE without any parameters specified will display a quick
  86.              reference to RNODE's command line format.
  87.  
  88.          3.) Next depending on the number of lines you have, you will need to
  89.              create a event to run RNODE on every line other than the one which
  90.              is actually running a system event. So the first step would be to
  91.              go into RBBS's CONFIG.EXE and hit Shift + F4, this will bring you
  92.              to the options for events, net-mail etc. Select option # 261
  93.              and enter a time to run RNODE, this time factor is very important,
  94.              and requires further explanation, RNODE should be setup as in the
  95.              following table, this example is for a 4 node RBBS system:
  96.  
  97.              Node 1 - Runs system event at 0200 (2:00 am)
  98.              Node 2 - Runs RNODE event at 0159 (1:59 am)
  99.              Node 3 - Runs RNODE event at 0158 (1:58 am)
  100.              Node 4 - Runs RNODE event at 0157 (1:57 am)
  101.  
  102.              Notice the time factors in which RBBS is set to exit to DOS, the
  103.              reason each node is set 1 before the other, is because if a node
  104.              exits at exactly the same time, this may cause problems with RBBS,
  105.              such as sharing violations, abnormal termination etc.
  106.  
  107.          4.) The final step to setting up RNODE on the example 4 node system is
  108.              to create a batch file for each node to run RNODE, the files
  109.              should look similar to the following:
  110.  
  111.              Node 1 Event Batch File - RBBSTM1.BAT
  112.              @ECHO OFF
  113.              CLS
  114.              <event commands>
  115.              RBBS1
  116.  
  117.              Node 2 Event Batch File - RBBSTM2.BAT
  118.              @ECHO OFF
  119.              CLS
  120.  
  121.  
  122.     RNODE.DOC                                          Page:3
  123.  
  124.  
  125.  
  126.              RNODE 120 C:\RBBS\NODE1\RBBS1TM.DEF
  127.              RBBS2
  128.  
  129.              Node 3 Event Batch File - RBBSTM3.BAT
  130.              @ECHO OFF
  131.              CLS
  132.              RNODE 180 C:\RBBS\NODE1\RBBS1TM.DEF
  133.              RBBS3
  134.  
  135.              Node 4 Event Batch File - RBBSTM4.BAT
  136.              @ECHO OFF
  137.              CLS
  138.              RNODE 240 C:\RBBS\NODE1\RBBS1TM.DEF
  139.              RBBS4
  140.  
  141.          The above example may seem rather confusing at first, but actually it
  142.          is quite simple....The time factors you tell RNODE and RBBS is the
  143.          most important. The numeric digits you give to RNODE is the number of
  144.          seconds to delay before going back to check for a signal file, usually
  145.          this should be set to a miminum of 2 minutes, then for each additional
  146.          node add 1 minute, so for example node 2's batch file delays 2 minutes
  147.          (120 seconds) before going back to see if node 1 (the node which is
  148.          running the event) has completed, node 3's batch file delays 3 minutes
  149.          (180 seconds) before going back to see if node 1's event is done.
  150.  
  151.          If you are running an event on a node other than node 1, simply change
  152.          the above batch files to check for a RBBSxTM.DEF file where x is the
  153.          node number and the path name to the file appropriately.
  154.  
  155.          Note: The above batch files are included in the RNODE distribution
  156.                archive.
  157.  
  158.          Additional Program Notes
  159.          ========================
  160.          The following should cover most questions you may have about RNODE:
  161.  
  162.          Note 1 - RNODE fully supports up to 36 nodes (the maximum number of
  163.                   nodes RBBS itself supports) and thus locks and unlocks it's
  164.                   files appropriately.
  165.  
  166.          Note 2 - RNODE will NOT place a node online until the system event for
  167.                   the node you chose has FULLY completed. In order for this to
  168.                   function properly, you MUST tell RNODE the correct event
  169.                   signal file, the example included in this guide show what a
  170.                   typical setup for RNODE would be on a system which runs the
  171.                   actual event on node 1.
  172.  
  173.          Note 3 - RNODE as stated earlier is designed for use in "network"
  174.                   enviroments and multitaskers, it is only necessary to run
  175.                   RNODE from one copy, what this means is that you can install
  176.                   multiple copies of RNODE, or simply run one copy. If you are
  177.                   using one copy, we recommend you mark the RNODE.EXE file
  178.                   read-only, as this can prevent sharing violations which may
  179.                   occur when multiple nodes try to access RNODE. This can be
  180.  
  181.  
  182.     RNODE.DOC                                          Page:4
  183.  
  184.  
  185.  
  186.                   done with the utility ATTRIB included with DOS, change to
  187.                   your directory containing the RNODE files and type the
  188.                   following: ATTRIB +R RNODE.EXE <--This will make your
  189.                   RNODE.EXE file read-only.
  190.  
  191.          Note 4 - Many people ask the same question "Do I really need to use a
  192.                   program such as RNODE?". This is entirely up to you, however
  193.                   it is highly recommended for ANY multi-node system to run
  194.                   a program such as RNODE to disable ALL nodes while a system
  195.                   event is running. This can save yourself a lot of work, as it
  196.                   prevents problems associated with running a program at
  197.                   the same time, this includes conflicts, sharing violations,
  198.                   files becoming corrupted, lock-ups - you name it, to be safe
  199.                   you should run a disable utility like RNODE.
  200.  
  201.          Note 5 - You may install RNODE anywhere you wish, the installation
  202.                   instructions in this guide are included only as an example,
  203.                   this gives you complete control over where you want the
  204.                   RNODE files installed, however for all installation methods
  205.                   we recommend that you install RNODE in your PATH statement,
  206.                   as this allows you to run the program from any other
  207.                   directory, without having to change to the directory in
  208.                   which RNODE's files are located.
  209.  
  210.          Registration
  211.          ============
  212.          RNODE 1.0 is being distributed under the shareware concept,
  213.          you are free to use this product for a period of 30 days after
  214.          which you must either register the program or discontinue it's use.
  215.          Registration is only $10.00, registering RNODE will get rid of
  216.          the UNREGISTERED notices contained in the program. When you register
  217.          RNODE you will receive a registered copy of the software on
  218.          your choice of 3 1/2" or 5 1/4" disk. As well as a registered key
  219.          file that displays your registration number on the main title screen,
  220.          the latest version, complete documentation and lifetime support.
  221.          To register your copy please complete the included form (REGISTER.FRM)
  222.          and return it to the address on the form.
  223.  
  224.          Questions And Or Comments
  225.          =========================
  226.          If you have questions or comments about this or any other
  227.          Lightning Software product, please write to the address below
  228.          or call the Lightning Software support BBS (Bear Cat BBS)
  229.          at (404) 739-1216 24 hours a day.
  230.  
  231.  
  232.                                   Lightning Software
  233.                                      P.O. Box 177
  234.                                 Lithia Springs, Ga 30057
  235.  
  236.  
  237.  
  238.  
  239.